Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 20 - QuickDraw 3D Mathematical Utilities / QuickDraw 3D Mathematical Utilities Reference

QuickDraw 3D Mathematical Utilities / Transforming Points and Vectors

Q3Point3D_To4DTransformArray

You can use the Q3Point3D_To4DTransformArray function to apply a transform to each point in an array of three-dimensional points, while changing the dimension of each point from three to four dimensions.

TQ3Status Q3Point3D_To4DTransformArray (
const TQ3Point3D *inVertex, 
const TQ3Matrix4x4 *matrix, 
TQ3RationalPoint4D *outVertex, 
long numVertices, 
unsigned long inStructSize, 
unsigned long outStructSize);

inVertex

A pointer to an array of three-dimensional points. This is the source array.

matrix

A 4-by-4 matrix.

outVertex

A pointer to an array of four-dimensional points. This is the destination array.

numVertices

The number of vertices.

inStructSize

The size of an element in the source array. Effectively, this is the distance, in bytes, between successive points in the source array.

outStructSize

The size of an element in the destination array. Effectively, this is the distance, in bytes, between successive points in the destination array.

DESCRIPTION

The Q3Point3D_To4DTransformArray function returns, in the outVertex parameter, an array of four-dimensional points, each of which is the result of changing the dimensionality of a point in the inVertex array from three to four and multiplying by the matrix transform matrix. The outVertex array contains the same number of points (that is, vertices) as the inVertex array, as specified by the numVertices parameter. The inStructSize and outStructSize parameters specify the sizes of an element in the inVertex and outVertex arrays, respectively.